Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / parc2.arc / PARC.DOC < prev next >

Wrap

Text File | 1991-03-01 | 17.1 KB | 359 lines

PARC.EXE (tm) v2.0r COPYR. 1991 DataWare All Rights Reserved 03/91 Purge ARChive file utility (tm) ┌─────────┐ ┌─────┴───┐ │ MEMBER ───┤ │ ├──────────────── │ ┌──────┴──┐ │ Association of │ │ ├──┘ Shareware └──┤ ■ │ Professionals ──────┤ ║ ├─────────────────── └────╨────┘ THIS IS NOT FREE SOFTWARE! Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registra- tion while others require it, some specify a maximum trial period. With regis- tration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribu- tion. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can TRY BEFORE YOU BUY. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee - if you don't use the product, you don't pay for it! The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. DISCLAIMER ---------- USERS OF PARC MUST ACCEPT THIS DISCLAIMER OF WARRANTY! "PARC is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of PARC." PARC is a "shareware program" and is provided at no charge to the user for evaluation. AGREEMENT Page 2 --------- PARC MAY BE DISTRIBUTED FREELY WITHOUT CHARGE AS LONG AS IT REMAINS UNALTERED WITH ALL ORIGINAL FILES INCLUDED IN A SINGLE UNIT. PARC MUST NOT BE INCLUDED AS PART OF ANOTHER SYSTEM/PROGRAM. USER GROUPS MAY CHARGE A SERVICE FEE NOT TO EXCEED $5.00 TO COVER THE COST OF COPYING OR DISSEMINATION. IT MUST BE MADE CLEAR THAT THIS CHARGE IS IN NO WAY A REGISTRATION OR LICENSE FEE. GRANTING THE RIGHT TO DISTRIBUTE THE EVALUATION COPY OF PARC DOES NOT IN ANY WAY INDICATE OWNERSHIP IN ANY FORM. ANY OTHER USE, DISTRIBUTION OR REPRESENTATION OF PARC IS EXPRESSLY FORBIDDEN WITHOUT THE WRITTEN CONSENT OF DATAWARE. Anyone distributing PARC for any kind of remuneration must first contact DataWare at the address below for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering PARC immediately (However DataWare must still be advised so that the distributor can be kept up-to-date with the latest version of PARC). Please see file VENDOR.DOC. Registration ------------ If you find this program useful and find that you are using PARC and continue to use PARC after a reasonable trial period, you *MUST* make a registration payment of $15.00 US for a non-commercial single-user license. The $15.00 registration fee will license one copy for use on any one computer at any one time. A one-time "site license" registration fee for commercial or multi-system use is $95.00 US. Users outside of the US and Canada should include $5.00 for international postage. Ohio residents must include 5.75% sales tax. Please see file PARC.REG. Send check or money order to: DataWare P.O. Box 13183 Columbus, OH 43213-9998 Registered users will be shipped a current copy of parc excluding all references to registration. Registered users will also receive the next version of PARC at no cost (when available) before general distribution of the evaluation copy is released. Commercial users of PARC must register and pay for their copies of PARC within 30 days of first use or their license is withdrawn. You are encouraged to pass a copy of the unregistered shareware version of PARC along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. Archive Contents Page 3 ---------------- The complete PARC archive should contain the following files under the archive names of PARC2.SDN or PARC2.ZIP as they are distributed in both forms. Filename Size Description --------------------------------------------------- PARC .EXE 39330 executable file PARC .DOC 17461 documentation for PARC PARC .REG 6180 registration info & form PARC .OMB 610 ASP Ombudsman info VENDOR.DOC 5619 Vendor info & form What Is PARC? ------------- PARC is a handy archive file clean-up utility that searches archives automatic- ally removing files that have been extracted from archives without the use of other extraneous file deletion utilities. Limitations ----------- PARC handles most popular archive formats; ZIP/ARC/PAK-SDN/LZH-ICE/ZOO/ARJ and their respective COM & EXE archive formats . This version does not handle LHA v2.xx archives (new) or SDN self-extracting archives (uncommon). PARC *MAY* NOT HANDLE ARCHIVES THAT USE CERTAIN SPECIALIZED OPTIONS. These options are few, and seldom used. PARC will handle a maximum of 512 files. EGA/VGA 43/50 line mode: When initiated the current number of screen lines and video mode are stored. The video mode and lines are then changed to 43 or 50 lines depending on whether you have an EGA or VGA adapter. Upon exit of the verify window, the previous lines and video mode are restored. Certain adapt- ers don't respond well to this restoration process and may confuse the adapter causing the display to become irregular. Requirements ------------ PARC requires a minimum of 75k of memory to operate. It will run fully on any IBM PC compatible with a graphics adapter and DOS 2.x or higher with 256K. NOTE: If you are using DOS 2.x you will not be able to access the default configuration if it is not in the current directory. See docs on ENVIRONMENT VARIABLE below. Installation ------------ Copy PARC.EXE to a directory which is in the PATH. It may then be called from anywhere on your drive. If you are using a command-line editor such as CED you can place it anywhere and assign a synonym to call it directly from that location. Environment Variable -------------------- If, when trying to configure PARC.EXE (/c option), PARC says it can't find itself, set the PARC environment variable. Include the full path to the exec- utable. You may put this in the autoexec.bat file or type it at the DOS prompt. Example: set PARC=C:\UTILS\PARC.EXE How PARC Works Page 4 -------------- PARC locates the archive(s) which you have designated on the command-line (may include paths and/or wildcards), reads the filenames contained within and searches the *CURRENT* directory to see if any of its files exist. If files from the archive(s) exist in the current directory the filenames will be dir- ected to a window where you decide which (if any) to delete. Quick Start ----------- If you would like to give PARC a try so that you can see what it does before reading on, try the following: Create a one or more archives in an empty directory. Extract all the files from the archive(s). Run PARC *.* Remember...PARC *SAVES* the tagged files in the archive window! Try setting the default configuration with PARC /c and running it again. Other options can be seen by just running PARC without any parameters. ARCHIVE Verify Window --------------------- Files in the window are pre-sorted and appear alphabetically left to right. The "lightbar" will be highlighting the first item. In the upper left corner of the files window is a status line that indicates which archive the file belongs to. We are all used to deleting files by tagging the items we want to delete and executing. After using PARC for a while I found that I was almost always deleting all of the extracted files or just keeping the .EXE and/or .DOC files and deleting the rest. For this reason PARC *SAVES* the files tagged and del- etes the rest. This is especially awkward at first but it does make more sense. In time you will get used to it. If not, use the REVERSE TAG feature. To move around in the Archive Verify Window environment use the cursor keys and HOME/END keys. Pressing the first letter of the filename will also move the lightbar to that file. To TAG/UNTAG a file, highlight that file and press RETURN (ENTER). If you move the "lightbar" over a tagged file the "lightbar" will flash indicating it is already tagged. Once you have tagged the files you wish to save, press F10 and confirm (optional) to execute the removal of files. Additional verify window options follow. ESC: You may press the ESCAPE key at any time to abort the window and program. NOTE: CTRL-BREAK will also abort safely at anytime during program operation except when being prompted for confirmation. F10: EXECUTE. Once pressed you will be asked at the bottom of the screen to "Confirm the deletion of items *NOT* tagged (y/n/ESC)?". This prompt is designed to give you one last chance to change your mind. It is defaulted to "Y" so you need only hit the RETURN to continue. Pressing ESC or "N" will place you back into the files window exactly as is was prior to pressing F10. Pressing any other key at this prompt will result in a short beep indicating an incorrect choice. Confirmation is optional and may be turned off in the configuration. ADDITIONAL VERIFY WINDOW OPTIONS (cont.) Page 5 F1 : TAG ALL. Useful if you wish to keep all but one or two files. Simply untag the files you wish to delete. F2 : UNTAG ALL. Useful if you have changed your mind and wish to start over. F3 : REVERSE TAG. As I stated previously, it is difficult to get used to tagging the items you want to save rather than delete. If you realize you have tagged the files in a backward fashion, simply use the REVERSE TAG to correct. F4 : TAG ASSOCIATED FILES. This can be very useful! If you have files from several archives in the current directory and wish to keep the files associated with a particular archive you need only highlight a file from that archive and press F4. All files from that archive will then be tagged. You can also use the REVERSE TAG feature in addition, to dispose of just those files. Maybe you just want to know which files are associated with a particular archive. PARC Command-Line ----------------- Syntax: PARC [archive-filename.ext] [{-/}option] The command-line is very flexible. Wildcards are encouraged. Some Examples: PARC on the command-line by itself will show the copyright, point of contact, command-line help and a disclaimer. PARC test.zip removes files from the current directory belonging to test.zip. PARC b:stuff.arc reads stuff.arc on drive b: and removes its files from the current directory. PARC test.zip b:stuff.* reads test.zip from current directory and any archives named stuff from drive b: and removes files associated with those archives from the cur- rent directory. PARC *.* the most common usage; reads all EXE/COM/ARCHIVE files located in the current directory and removes any files associated with them from the current directory. NOTE: If the filename within an archive includes a path, the path is parsed and only the filename is searched for in the current directory. In other words, PARC will not look for or delete files extracted from archives outside of the current directory. PARC Command-Line Options Page 6 ------------------------- Options may be placed anywhere on the command-line as long as they are spaced and are preceded by a "/" or "-" indicator. Illegal options are ignored. Examples: PARC *.* /v /d PARC -f PARC /c PARC -vo *.* /V : Turns off the verify window. Handy if deleting all files. /D : Turns off the duplicate file filter. This allows the user to determine which archives contain the same filename(s). NOTE: When using the /D option the archive file count in the verify window reflects duplicate files within archives, therefore the file count is inaccurate. /F : Standard file deletion utility. Allows deletion of files with attribute of archive or hidden. The /V option will automatically be over-ridden so that the verify window will *ALWAYS* be active. NOTE: This parameter ignores filespecs on the command-line. It will read all files in the current directory with the above attributes. It was designed to delete archive files or extraneous files created while testing programs without calling a separate utility. WARNING: This window operates in a normal fashion and *DELETES* tagged items unlike the archive window which *SAVES* tagged items. /C : Runs internal configuration. Allows various default options to be set. NOTE: The configuration is internal to the PARC.EXE file. PARC should find itself even if renamed or called via a synonym from CED or other type command-line editors. DOS 2.x users will need to set the PARC environ- ment variable to find the executable file if PARC is not in the cur- rent directory. /VO: Command-line over-ride; enables the use of the verify window if /V is the default in the configuration file. /DO: Command-line over-ride; enables the use of the duplicate filter if /D is the default in the configuration file. PARC History Page 7 ------------ PARC was originally called MARCH (MopARCHive) and was released to the public domain. The name has been changed to PARC for this Shareware release. Contact ------- All suggestions for improvement or of criticism will be graciously accepted via the following points of contact. DataWare P.O. Box 13183 Columbus, OH 43213-9998 CIS : 71470,1007 BBS : Utilities Exchange (U.S.A.) (614) 442-6695 UUCP: ohio-state.edu!osu-cis!bluemoon!dgaulden The PARC Shareware evaluation program will be distributed via the Shareware Distribution Network (SDN), CIS, and various user groups. IBM is a registered trademark of International Business Machines Corp CED is Copyrighted (c) 1985 by Christopher J. Dunford